Skip to content

Comments

docs: add version bump annotations to all commit type descriptions#1875

Open
danielalanbates wants to merge 1 commit intocommitizen-tools:masterfrom
danielalanbates:fix/issue-515
Open

docs: add version bump annotations to all commit type descriptions#1875
danielalanbates wants to merge 1 commit intocommitizen-tools:masterfrom
danielalanbates:fix/issue-515

Conversation

@danielalanbates
Copy link

Description

Adds SemVer version bump information to all commit type descriptions, addressing the remaining task from #515.

PR #1452 previously corrected the bump rules on the documentation page, but the second task from #515 was still open:

Add notes in commit message instructions to identify what version bump occurs with all change types (e.g. Correlates with no version bump in SemVer)

Changes

commitizen/cz/conventional_commits/conventional_commits.py — Interactive prompt (cz commit) descriptions now indicate the version bump for each type:

  • refactor and perf: Added "Correlates with PATCH in SemVer"
  • docs, style, test, build, ci: Added "No version bump"

commitizen/cz/conventional_commits/conventional_commits_info.txt — The cz info output now explicitly documents that refactor and perf correlate with PATCH, and clarifies that other types do not trigger a version bump.

docs/tutorials/writing_commits.md — The Commit Types section now:

  • Lists refactor and perf alongside feat and fix as types that affect semantic versioning
  • Explicitly marks docs, style, test, build, ci, chore as triggering no version bump
  • Mentions that Commitizen uses Angular Convention commit types by default
  • Corrects the note that previously stated only feat and fix affect versioning

Checklist

Documentation Changes

  • Run poetry doc locally to ensure the documentation pages renders correctly

Closes #515

This PR was created with the assistance of Claude Opus 4.6 by Anthropic. Happy to make any adjustments!

Add SemVer version bump information to all commit type descriptions in
the interactive prompt, info text, and writing commits documentation.

Previously, only `feat` and `fix` indicated their SemVer correlation.
Now `refactor` and `perf` explicitly state they correlate with PATCH,
and `docs`, `style`, `test`, `build`, and `ci` explicitly state they
do not trigger a version bump.

This addresses the remaining task from issue commitizen-tools#515 which requested that
commit message instructions identify what version bump occurs with all
change types.

Closes commitizen-tools#515

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Feb 20, 2026

⚠️ JUnit XML file not found

The CLI was unable to find any JUnit XML files to upload.
For more help, visit our troubleshooting guide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bumping rule is wrongly documented

1 participant